Skip to content

feat: add rhdh-jira skill for Jira interaction via acli#13

Merged
schultzp2020 merged 1 commit into
redhat-developer:mainfrom
schultzp2020:feat/rhdh-jira-skill
May 6, 2026
Merged

feat: add rhdh-jira skill for Jira interaction via acli#13
schultzp2020 merged 1 commit into
redhat-developer:mainfrom
schultzp2020:feat/rhdh-jira-skill

Conversation

@schultzp2020

Copy link
Copy Markdown
Collaborator

Summary

Foundational agent skill for interacting with RHDH Jira projects (RHIDP, RHDHPLAN, RHDHBUGS, RHDHSUPP) using the Atlassian CLI (acli). Designed as the base layer that future specialized skills can build on.

Structure

File Purpose
SKILL.md Setup, project table, gotchas, error handling, routing, common workflows
references/acli-commands.md Command cheat sheet with flag gotchas and output format differences
references/fields.md Custom fields, labels, link types, components, priorities
references/workflows.md Issue type state machines + exit criteria for Feature, Epic, Story/Task, Bug, Feature Request
references/templates.md Jira wiki markup templates for all 7 issue types
references/support.md RHDHSupp/RHDHBUGS support case workflow + SLAs
references/jql-patterns.md 23+ tested JQL queries + board/sprint reference tables
scripts/setup.py Verify acli install + auth (smoke tests, not acli auth status which lies with API tokens)
scripts/parse_issues.py Flatten, enrich, and filter acli JSON output — bridges the gap where acli search --json can't return custom fields

Validation

  • All 23+ JQL queries tested live against redhat.atlassian.net
  • All acli command flags verified against --help
  • All 14 custom field IDs verified against real issue data
  • Both scripts tested and passing
  • Two rounds of expert review completed (skill-writing + Jira QA)
  • All 245 project tests pass, ruff lint/format clean

Key design decisions

  • One skill with references (impeccable pattern) instead of a family of separate skills — reduces routing complexity
  • acli-commands.md is a cheat sheet, not a full manual — trusts acli --help for details
  • parse_issues.py solves the fix: use CLAUDE_PLUGIN_ROOT for CLI path in skills #1 acli pain point: search can't return custom fields (team, story points, sprint). The script enriches via acli view per issue, then flattens and filters.
  • Exit criteria framed as operational requirements, not process knowledge
  • RHDHPAI documented as archived — prevents agents from hitting JQL errors

Foundational agent skill for interacting with RHDH Jira projects
(RHIDP, RHDHPLAN, RHDHBUGS, RHDHSUPP) using the Atlassian CLI (acli).

Skill structure:
- SKILL.md: Setup, project table, gotchas, error handling, routing
- references/acli-commands.md: Command cheat sheet with flag gotchas
- references/fields.md: Custom fields, labels, link types, components
- references/workflows.md: Issue type state machines + exit criteria
- references/templates.md: Jira wiki markup templates for all issue types
- references/support.md: RHDHSupp/RHDHBUGS support case workflow
- references/jql-patterns.md: 23+ tested JQL queries + board/sprint ref
- scripts/setup.py: Verify acli install + auth
- scripts/parse_issues.py: Flatten, enrich, filter acli JSON output

All JQL queries tested live. All acli flags verified against --help.
Two rounds of expert review (skill-writing + Jira QA) completed.
@schultzp2020 schultzp2020 merged commit 851a0c4 into redhat-developer:main May 6, 2026
3 checks passed
@schultzp2020 schultzp2020 deleted the feat/rhdh-jira-skill branch May 6, 2026 03:44
durandom pushed a commit to durandom/rhdh-skill that referenced this pull request May 13, 2026
…t session

- Add Gotcha redhat-developer#13: acli search silently truncates at 30 results
- Rewrite Gotcha redhat-developer#9: acli cannot set custom fields (no --custom flag)
- Expand Gotcha redhat-developer#8: labels also missing from basic field output
- Fix error table: REST search returns 410, not a valid fallback
- acli-commands.md: add warning about default page size, update examples to --limit 200
- graphql-queries.md: operation names are mandatory now, not future
- rest-api-fallback.md: document 410 Gone on /rest/api/3/search
- jql-patterns.md: cross-project parent=KEY only works via acli
- refine.md: add refinement context (pre-release prep vs freeze triage)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant